====== Comment exporter la documentation pour une consultation Offline ======
===== Méthode principale =====
<note important>La méthode donnée ci dessous, est la méthode que j'ai utilisé et qui m'a permis de créer en 2015, une archive complète de la documentation.</note>

<note tip>**Données techniques au 01/10/2015**

L'export a été fait sur un pc portable :
  * un processeur i7 4 coeurs
  * 8 Go de RAM
  * HDD 500 Go
  * Kubuntu 15.04 64 bit

L'exportation des 6500 page a duré 41h.

la création du fichier zim : entre 5 et 10 min.
</note>

==== Préparation de l’environnement ====
=== Installation du serveur web ===
Dans un premier temps, nous allons installer le serveur web qui va nous permettre de mettre en place une copie du site de la documentation. J'ai personnellement utilisé Apache, il est possible d'utiliser n'importe quel serveur web supportant php5.(pour plus d'information voir [[:lamp|Serveur Web - LAMP]])

<code>apt-get install apache2 libapache2-mod-php5</code>

<note>Je n'ai pas installé Mysql, parce que le site de la documentation ne le nécessite pas.</note>

Il faut configurer Apache et php afin d'éviter des problèmes d'exportation.

<note warning>**Attention**

Certains paramètres sont vivement déconseillés sur des serveurs en production. Ils peuvent conduire à une saturation du serveur. La modification de ces paramètres est nécessaire, sinon l'exportation échoue. Éviter d'avoir plusieurs scripts ou plusieurs sites sur le même PC. Si nécessaire, pour les paramètres php, il est possible de passer par un fichier .user.ini à la racine du wiki(utile si plusieurs sites sont servi par le serveur Apache).
</note>

Editer le fichier /etc/apache2/apache.conf avec votre éditeur de texte favori.

<file>
ServerName localhost #Pour éviter l'alarme au démarrage d'Apache
Timeout 300 # On augmente de manière significative la durée passant de 30 secondes à 5 min
# A modifier si existant ou à rajouter voir la documentation de dokuwiki
<Directory /var/www/>
	Options Indexes FollowSymLinks
	AllowOverride None
	Require all granted
</Directory>
</file>
=== Installation de Bazaar ===


  * Installation de bazaar : (pour plus d'information voir [[:bzr|Bazaar]])
<code>apt-get install bzr</code>
  * 

===== Méthode « manuelle » =====

Commencer par récupérer le code de dokuwiki que nous utilisons et se créer une instance locale (ou sur un serveur distant).
  * [[:groupes:ubuntu-fr-webteam#comment_nous_aider]]
  * [[:groupes:ubuntu-fr-webteam:tester_les_outils]]

Demander une copie de sauvegarde du dossier **data** aux administrateurs système (ou utiliser autre chose si c'est pour faire des tests, comme par exemple le dossier data fourni avec une dokuwiki normal).

Installer le [[doku>plugin:siteexport|plugin dokuwiki **siteexport**]], soit manuellement en le décompressant dans le dossier **lib/plugins/** soit en utilisant l'interface d'administration de votre instance de dokuwiki.

Se rendre dans l'interface d'administration, un nouvel élément Export du site devrait être là. C'est là dedans que tout se passe, réglages fin et lancement de l'export partiel ou total.

FIXME la suite

création d'un fichier ZIM[[:utilisateurs:nicolah:zimwriterfs]]